<!DOCTYPE html>
<html>
    <head>
        <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
        <title>Turn on debug mode in Dovecot</title>
        <link rel="stylesheet" type="text/css" href="./css/markdown.css" />
    </head>
    <body>

    <div id="navigation">
    <a href="https://www.iredmail.org" target="_blank">
        <img alt="iRedMail web site"
             src="./images/logo-iredmail.png"
             style="vertical-align: middle; height: 30px;"
             />&nbsp;
        <span>iRedMail</span>
    </a>
    &nbsp;&nbsp;//&nbsp;&nbsp;<a href="./index.html">Document Index</a></div><div class="admonition note">
<p class="admonition-title">This tutorial is available in other languages. <a href="https://github.com/iredmail/docs">Help translate more</a></p>
<p><a href="./debug.dovecot-nl_DU.html">Nederlands</a> / <a href="./debug.dovecot-zh_CN.html">简体中文</a> /</p>
</div>
<h1 id="turn-on-debug-mode-in-dovecot">Turn on debug mode in Dovecot</h1>
<blockquote>
<p>Don't know where Dovecot config files are? check this tutorial:
<a href="file.locations.html#dovecot">Locations of configuration and log files of major components</a>.</p>
</blockquote>
<p>To turn on debug mode in Dovecot, please update below parameter in Dovecot
config file <code>dovecot.conf</code>:</p>
<pre><code>mail_debug = yes
</code></pre>
<p>Restart Dovecot service.</p>
<p>If you need authentication and password related debug message, turn on related
settings and restart dovecot service.</p>
<pre><code>auth_verbose = yes
auth_debug = yes
auth_debug_passwords = yes

# Set to 'yes' or 'plain', to output plaintext password (NOT RECOMMENDED).
auth_verbose_passwords = plain
</code></pre>
<p>If Dovecot service cannot start, please run it manually, it will print the
error message on console:</p>
<pre><code class="language-shell">dovecot -c /etc/dovecot/dovecot.conf
</code></pre>
<h2 id="debug-ldap-queries">Debug LDAP queries</h2>
<p>If you're running iRedMail with OpenLDAP backend, you can increase debug level
for LDAP in <code>/etc/dovecot/dovecot-ldap.conf</code> with parameter <code>debug_level</code>,
add or update it to <code>1</code>, then restart dovecot service:</p>
<pre><code>debug_level = 1
</code></pre>
<p>You can also set it to <code>-1</code> which means everything.</p><div class="footer">
    <p style="text-align: center; color: grey;">All documents are available in <a href="https://github.com/iredmail/docs/">GitHub repository</a>, and published under <a href="http://creativecommons.org/licenses/by-nd/3.0/us/" target="_blank">Creative Commons</a> license. You can <a href="https://github.com/iredmail/docs/archive/master.zip">download the latest version</a> for offline reading. If you found something wrong, please do <a href="https://www.iredmail.org/contact.html">contact us</a> to fix it.</p>
</div></body></html>